android.ndk.surface_texture

1 /*
2  * Copyright (C) 2018 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 /**
18  * @addtogroup SurfaceTexture
19  * @{
20  */
21 
22 /**
23  * @file surface_texture_jni.h
24  */
25 
26 module android.ndk.surface_texture_jni;
27 
28 import arsd.jni;
29 import android.ndk;
30 
31 extern (C):
32 nothrow:
33 @nogc:
34 
35 /**
36  * Get a reference to the native ASurfaceTexture from the corresponding java object.
37  *
38  * The caller must keep a reference to the Java SurfaceTexture during the lifetime of the returned
39  * ASurfaceTexture. Failing to do so could result in the ASurfaceTexture to stop functioning
40  * properly once the Java object gets finalized.
41  * However, this will not result in program termination.
42  *
43  * \param env JNI environment
44  * \param surfacetexture Instance of Java SurfaceTexture object
45  * \return native ASurfaceTexture reference or nullptr if the java object is not a SurfaceTexture.
46  *         The returned reference MUST BE released when it's no longer needed using
47  *         ASurfaceTexture_release().
48  */
49 ASurfaceTexture* ASurfaceTexture_fromSurfaceTexture (JNIEnv* env, jobject surfacetexture);
50 
51 /* ANDROID_NATIVE_SURFACE_TEXTURE_JNI_H */